前端analysis | 知其所以然

Flutter Windows 开发过程问题解决

2025-07-24

1. 确保已经安装 Flutter SDK

首先,确保的系统上安装了 Flutter SDK。如果没有安装,可以参考以下步骤:

安装 Flutter SDK:

  1. 访问 Flutter 官网 并下载适用于操作系统的 Flutter SDK。

  2. 解压下载的文件并将 Flutter 添加到系统路径中。

    • Windows:将 flutter/bin 目录添加到环境变量 PATH 中。

    • Mac/Linux:在 .bashrc.zshrc 文件中添加以下行:

      1
      export PATH="$PATH:`<flutter_sdk_path>/flutter/bin"

确认 Flutter 是否安装:

在终端或命令提示符中运行以下命令来确认 Flutter 是否安装成功:

1
flutter --version

2. 安装 Android Studio 或其他 IDE(用于模拟器)

确保有一个 Android 模拟器,或者已连接真实设备(如果要进行 Android/iOS 开发)。可以安装 Android Studio 或直接使用 VS Code 进行开发,但 Android Studio 带有模拟器,便于开发。

  • Android Studio:安装 Android Studio,并确保安装了 Android SDK 和模拟器。
  • VS Code:VS Code 本身无法直接启动模拟器,但可以通过 Android Studio 提供的模拟器进行配合。

3. 在 VS Code 中安装 Flutter 插件

为了在 VS Code 中开发 Flutter 应用,需要安装两个插件:FlutterDart

安装 Flutter 和 Dart 插件:

  1. 打开 VS Code
  2. 转到 扩展(Extensions)视图:点击左侧活动栏中的 扩展 图标,或者使用快捷键 Ctrl+Shift+X
  3. 在搜索框中输入 Flutter,然后点击 安装
  4. 在搜索框中输入 Dart,然后点击 安装

4. 通过 VS Code 打开 Flutter 项目

  1. 使用 VS Code 打开由 GitHub Copilot 创建的 Flutter 项目文件夹。点击 文件 > 打开文件夹,然后选择的 Flutter 项目文件夹。

  2. 可以在 VS Code 的 终端(Terminal)中运行以下命令,确保所有依赖已安装:

    1
    flutter pub get

5. 连接设备或启动模拟器

  1. 连接设备:如果有 Android 或 iOS 设备连接到计算机,可以直接使用设备运行应用。

  2. 启动模拟器

    • 如果使用的是 Android Studio,可以通过 AVD 管理器(Android Virtual Device)启动模拟器。
    • 启动模拟器后,VS Code 会自动检测到模拟器。

    也可以通过 命令面板Ctrl+Shift+P)运行以下命令:

    1
    Flutter: Launch Emulator

6. 在 VS Code 中运行 Flutter 应用

  1. 确保设备或模拟器已连接并显示在 VS Code 状态栏的 设备选择 处。

  2. 在 VS Code 中按下 F5 或点击 运行(Run)按钮来启动应用。也可以使用 终端 执行:

    1
    flutter run

VS Code 将会构建并运行的 Flutter 应用,输出将在 终端 中显示。

7. 调试与热重载

  • 在运行 Flutter 应用时,VS Code 支持热重载(Hot Reload)。只需点击 热重载 图标或在终端中输入 r,就可以查看代码修改后的效果。
  • 还可以设置断点并调试应用。

总结:

  • 确保安装了 Flutter 和 Dart 插件。
  • 通过 VS Code 打开 Flutter 项目。
  • 确保连接设备或启动模拟器。
  • 使用 F5 运行应用,或通过终端输入 flutter run

8.avdmanager is missing from the Android SDK

1. 确保 Android SDK 安装完整

AVD Manager 是 Android Studio 中的一部分,但它依赖于 Android SDK 的某些工具。因此,确保的 SDK 已经安装并更新到最新版本。

安装或更新 SDK 工具:

  1. 打开 Android Studio

  2. 选择 Configure > SDK Manager

  3. SDK Tools 标签页中,确保以下工具已经选中并安装:

    • Android SDK Build-Tools
    • Android Emulator
    • Android SDK Platform-Tools
    • Android SDK Tools(如果显示)
  4. 点击 OK 以应用更改并安装缺失的工具。

2. 手动安装 AVD Manager

如果没有 Android Studio,或者只安装了命令行工具,可以手动安装并配置 AVD Manager

安装 AVD 工具:

  1. 打开终端或命令行。

  2. 使用 sdkmanager 工具来安装缺少的组件。确保已经将 Android SDK 的路径添加到 PATH 环境变量中。如果没有,可以在终端中运行:

    1
    2
    3
    4
    sdkmanager --update
    sdkmanager "system-images;android-30;google_apis;x86_64"
    sdkmanager "platform-tools"
    sdkmanager "emulator"

    上面的命令会安装 SDK 平台工具、模拟器和系统映像(适用于 Android 30)。

  3. 等待下载并安装完成。

3. 检查环境变量

确保 AVD Manager 所需的命令行工具在的 PATH 中。

设置环境变量:

  1. Windows

    • 打开 系统属性 > 高级系统设置 > 环境变量

    • 系统变量 中找到 Path,并点击 编辑

    • 添加以下路径(替换为实际的 Android SDK 路径):

      1
      2
      C:\Users\<YourUsername>\AppData\Local\Android\Sdk\tools
      C:\Users\<YourUsername>\AppData\Local\Android\Sdk\platform-tools
  2. Mac/Linux

    • 打开终端并编辑 .bashrc.zshrc 文件:

      1
      nano ~/.bashrc  # 或 nano ~/.zshrc
    • 添加以下行:

      1
      2
      export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/tools
      export PATH=$PATH:/Users/<YourUsername>/Library/Android/sdk/platform-tools
    • 保存并运行:

      1
      source ~/.bashrc  # 或 source ~/.zshrc

4. 使用命令行启动 AVD

如果没有 Android Studio 的图形界面,可以使用命令行启动 AVD:

  1. 打开命令行或终端。

  2. 使用以下命令启动模拟器:

    1
    emulator -avd <avd_name>

    其中,<avd_name> 是创建的虚拟设备名称。

    如果没有创建 AVD,可以通过以下命令创建一个新的虚拟设备:

    1
    avdmanager create avd -n <avd_name> -k "system-images;android-30;google_apis;x86_64"

5. 检查 AVD 是否可用

可以列出可用的 AVD:

1
avdmanager list avd

如果仍然无法找到 AVD Manager,可能是 SDK 安装有问题,尝试重新安装 SDK 或 Android Studio。

总结:

  • 确保 SDK 工具和模拟器已经正确安装。
  • 配置 PATH 环境变量,确保命令行工具可用。
  • 使用 avdmanager 命令手动创建 AVD(如果需要)。
  • 通过命令行启动模拟器,或者通过 Android Studio 使用 AVD Manager。

6.VS Code 中成功启用 GitHub Copilot,需要完成以下 5 个关键步骤


✅ 1. 安装 GitHub Copilot 插件

  1. 打开 VS Code

  2. Ctrl + Shift + X 打开扩展(Extensions)

  3. 搜索并安装插件:

    1
    GitHub Copilot

    ✅ 选择 GitHub 官方发布的那个(发布者是 GitHub


✅ 2. 登录的 GitHub 账户

  1. 安装后,VS Code 会提示:

    “GitHub Copilot requires authentication”

  2. 点击“Sign in”

  3. 浏览器会打开 GitHub 授权页面

  4. 确认授权并登录的 GitHub 账号

⚠️ 必须是:

  • 拥有 Copilot 订阅(付费或试用中)
  • 或属于 GitHub Copilot 企业授权的用户

✅ 3. 验证登录成功

登录成功后,可以:

  • 在 VS Code 命令面板中(Ctrl + Shift + P)输入:

    1
    Copilot: Status

    ✅ 若看到 “Logged in as your_github_name” 即为成功。


✅ 4. 启用自动补全

打开的代码文件(.dart, .js, .py, .cpp 等都支持),开始写函数名,Copilot 会自动在灰色字体中提示补全建议。

可以按:

  • Tab → 接受补全建议
  • Esc → 忽略建议

✅ 5. 可选:安装 Copilot Chat(对话增强版)

如果希望像 ChatGPT 那样和 Copilot 聊天,获取更复杂建议,还可以安装:

1
GitHub Copilot Chat

这个插件支持自然语言提问,例如:

“帮我写一个 Flutter 登录界面”
“优化这个函数的性能”


🛠️ 常见失败原因排查

问题 解决方法
登录失败 / 没有跳转到浏览器 手动执行 GitHub: Sign in 命令
提示 “Copilot setup failed” 使用 VPN,或设置代理 + 重新登录
看不到建议补全 关闭中文输入法、确认当前语言支持(如 Dart)
提示需订阅 登录 GitHub → https://github.com/settings/copilot 确认是否开通

6.✅ 附加建议:测试是否工作正常

可以在新文件中输入以下代码片段测试:

1
2
3
void main() {
// Copilot 应该会自动补全一个打印 hello world
}

看是否自动灰色提示 print("Hello World"); 或其它逻辑。


如操作中遇到某个具体步骤失败,欢迎贴出提示信息,我可以帮一步步修复。是否需要我检查现在的系统环境变量、代理配置或 Dart/Flutter 插件兼容性?

9. 在 Android Studio 或 VS Code 中配置 Virtual Device(模拟器) 时,选择合适的设备型号和系统镜像(API Level)非常关键。


✅ 推荐虚拟设备配置(2025 年通用建议)

类型 推荐选项 说明
设备型号 ✅ Pixel 4 / Pixel 5 主流分辨率、性能适中,适配广泛
✅ Pixel 6 / Pixel 7 (高性能) 测试新特性(如Material You),但更吃资源
✅ Nexus 5X (轻量) 对低配电脑更友好
系统版本 ✅ Android 13 (API 33) 现主流设备系统,Flutter 支持稳定
✅ Android 12 (API 31) 稳定、兼容性强
✅ Android 11 (API 30)(轻量备选) 更轻,占用内存小,可用于低端设备模拟
镜像类型 ✅ x86_64 或 ARM64 系统镜像 推荐选 x86_64(支持更快的 emulator 加速)
✅ Google APIs(非 Google Play) 大多数 Flutter 应用足够使用,不必安装 Play 支持版本
⚠️ Google Play 版本 体积大、启动慢,一般只在测试 Play 依赖时使用

🛠️ 示例推荐配置(开发+测试兼顾)

1
2
3
4
5
6
Device: Pixel 5
System Image: Android 13 (API 33) - x86_64 with Google APIs
RAM: 2048MB
Internal Storage: 2GB
SD Card: 512MB(可选)
Graphics: Hardware - GLES 2.0 / 3.0

❗ 不建议选择:

不推荐配置 原因
Android 10 以下 支持减弱,Flutter 新特性可能不兼容
Google Play 系统镜像 体积大、启动慢、更新频繁
ARM 映像(除非 M1/M2 Mac) 模拟速度慢,不支持加速

💡 Flutter 快速测试建议

可以选配两个虚拟设备:

目的 推荐设备 API 版本
日常开发调试 Pixel 5 Android 13
向下兼容测试 Nexus 5X Android 11
高端设备体验测试 Pixel 7 Android 14(如可用)

📌 重要提示:性能建议

  • 启用 Hardware Acceleration(加速),否则模拟器会非常卡
  • 如果是 AMD CPU,确保已启用 Windows Hypervisor Platform
  • 推荐使用 x86_64 镜像 + Cold boot only once 提高启动速度

10.当前的 Java 环境是:

1
2
3
openjdk 18 2022-03-22
OpenJDK Runtime Environment (build 18+36-2087)
OpenJDK 64-Bit Server VM (build 18+36-2087, mixed mode, sharing)

这表明已经安装了 OpenJDK 18,完全符合 Android 开发(尤其是 Android 14 / API 34)对 Java 版本的要求(Java 17 或更高)。


✅ 那么为什么仍然提示 “Java version 17 or higher is required”?

这种情况通常有两个可能原因:


🔍 原因 1:Android Studio / Gradle 没有使用当前的 JDK 18

即使安装了 JDK 18,如果的 JAVA_HOME 没有正确配置,Android Studio 或 flutter build 命令仍然可能默认使用旧版本 JDK(比如 JDK 8 或 JDK 11)。

✔️ 解决方法:

✅ 设置 JAVA_HOME 环境变量

Windows:
  1. 打开“环境变量设置”。

  2. 添加 / 修改系统变量:

    • 变量名JAVA_HOME

    • 变量值: JDK 18 的安装路径,比如:

      1
      C:\Program Files\Java\jdk-18
  3. 在系统变量 Path 中添加:

    1
    %JAVA_HOME%\bin
  4. 打开新终端,运行:

    1
    2
    java -version
    echo %JAVA_HOME%
macOS/Linux(bash/zsh):

编辑 ~/.bashrc~/.zshrc 文件,添加:

1
2
export JAVA_HOME=/path/to/your/jdk-18
export PATH=$JAVA_HOME/bin:$PATH

然后运行:

1
2
3
source ~/.bashrc  # 或 ~/.zshrc
java -version
echo $JAVA_HOME

🔍 原因 2:Android Studio 项目仍指向旧 JDK 路径

即使系统环境正确,Android Studio 本身可能还指向旧 JDK 路径

✔️ 在 Android Studio 中设置正确的 JDK 版本

  1. 打开 Android Studio。

  2. 进入菜单:File > Project Structure > SDK Location

  3. 找到 JDK Location 字段,点击右侧文件夹图标。

  4. 指向 JDK 18 的路径,如:

    1
    C:\Program Files\Java\jdk-18
  5. 点击 OK 保存设置,重启 Android Studio。


🔁 最后验证

确保以下命令都输出了 JDK 18 相关信息:

1
2
3
java -version
echo $JAVA_HOME # Linux/macOS
echo %JAVA_HOME% # Windows

如果是在使用 flutter 构建 Android 应用,也可以运行:

1
flutter doctor -v

确认输出中使用的是正确的 Java 路径和版本。


✅ 总结

项目 当前状态
已安装 OpenJDK 18 ✅ 没问题
是否满足 Android 14 要求 ✅ 满足(17+)
仍提示版本问题原因 多半是 JAVA_HOME 未正确设置或未被 Android Studio/Gradle 识别
使用支付宝打赏
使用微信打赏

若你觉得我的文章对你有帮助,欢迎点击上方按钮对我打赏